Skip to main content

fullMessage

FullMessage Model​

Represents a complete message object that may include metadata, attachments, and tool-related execution information.

id (integer, Read-only)​

Unique identifier of the message.

attachments (array of MessageAttachment)​

A list of attached files related to this message.

role (string) Required​

The role of the message sender.

  • Enum values: "user", "assistant", "tool", "reasoning", "builtin_tool"

content (string) Required​

Textual content of the message.

  • Minimum length: 1 character

tool_call_id (string, Nullable)​

The ID of the tool call if the message is part of a tool execution sequence.

function_name (string, Nullable)​

The name of the function invoked via a tool call.

msg_num (integer) Required​

Message number in the conversation sequence.

likes (boolean, Nullable)​

Indicates whether the message was liked.

created_at (string, Read-only, date-time)​

Timestamp indicating when the message was created.

updated_at (string, Read-only, date-time)​

Timestamp of the last update to the message.

visible (boolean)​

Whether the message is visible in the conversation thread.

metadata (Metadata, Nullable)​

Key-value map of additional message metadata.

system_prompt (string, Nullable)​

The system-level prompt associated with this message.

functions (Functions, Nullable)​

Optional map of callable tool functions relevant to this message.

logs (array, Read-only)​

Execution logs associated with the message.

thought_signature (string, Nullable)​

Provider-specific thought signature metadata when returned by the generator.

reasoning_encrypted_content (string, Nullable)​

Encrypted reasoning content for reasoning-capable responses when available.

message_cost (string, Nullable)​

Message-level generation cost when pricing data is available.

response_pricing_id (integer, Nullable)​

Identifier for the pricing record used to calculate message_cost.

Example​

{
  "id": 0,
  "attachments": [
    {
      "original_file_name": "string",
      "file_content": "string",
      "metadata": {},
      "content_type": "application/pdf"
    }
  ],
  "role": "assistant",
  "content": "string",
  "tool_call_id": "string",
  "function_name": "string",
  "msg_num": 2147483647,
  "likes": true,
  "created_at": "2025-05-29T12:48:30.937Z",
  "updated_at": "2025-05-29T12:48:30.937Z",
  "visible": true,
  "metadata": {},
  "system_prompt": "string",
  "functions": {},
  "logs": [],
  "thought_signature": null,
  "reasoning_encrypted_content": null,
  "message_cost": "0.0001000000",
  "response_pricing_id": 1
}